JBoss Community Archive (Read Only)

RHQ 4.5

RHQAgent - Java Service Wrapper Launcher Service

Overview

Internal Name:

Java Service Wrapper Launcher

Description:

The Java Service Wrapper that can run the agent as a daemon service

Singleton:

yes

Plugin:

RHQAgent

Connection Settings

Name

Description

Required

Internal Name

Launcher Script

The full path to wrapper launcher script file

yes

launcherScript

Configuration File

The full path to the configuration file

yes

configurationFile

Environment File

The full path to the environment setup file

no

environmentFile

Include File

The full path to the include file

no

includeFile

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Configuration Properties

Name

Description

Required

Internal Name

Main Configuration Settings

The main JSW configuration. This is read-only - to customize the configuration, add settings to the environment and/or includes.

yes

mainConfigurationSettings

Environment Settings

Environment settings to further customize the JSW. These are set prior to applying the main configuration and include settings. Variables set here can be placed in the main config or includes using the %VAR% notation.

yes

environmentSettings

Include Settings

Override settings that augment the existing JSW configuration. These are applied after the main configuration is set.

yes

includeSettings

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Operations

Name

Description

Install

Installs the Java Service Wrapper so it starts the agent at boot time

Restart

Restarts the Java Service Wrapper and the agent it contains. This will completely kill the agent VM process (if it is running as this service) and then attempt to restart it. If the agent executing this operation will quickly die, no confirmation will be available as to the success or failure of this operation.

Stop

Stops the Java Service Wrapper and the agent it contains. This will completely kill the agent VM process (if it is running as this service). If the agent executing this operation will quickly die, no confirmation will be available as to the success or failure of this operation.

Remove

Removes the Java Service Wrapper so it no longer starts the agent at boot time. *NOTE* This will completely kill the agent VM process if it is running as this service. If the agent executing this operation will quickly die, no confirmation will be available as to the success or failure of this operation.

Status

Gets the status of the Java Service Wrapper

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-12 13:13:32 UTC, last content change 2012-05-09 12:34:21 UTC.